Copyright: Copyright © Corel Corporation Limited. 1996, 1997. All Rights Reserved.
Citation: Copyright © Corel Corporation Limited. 1996, 1997. All Rights Reserved.


About Corel PerfectScript

Corel PerfectScript is an application that you can use to record, play, compile, convert, and edit macros and to build or edit dialog boxes for macros. A macro is a series of commands and menu selections in a file that can be replayed by a few keystrokes or by a mouse click.

Use macros to record commands that perform tasks automatically. For example, you can create a macro that retrieves a file, gives it a new name, and saves it in another format.

Use About Corel PerfectScript for information about your version number, the release date, program paths, and memory usage.

For information about controls on any dialog box, click [image], then click a control.

Related Concepts


About Corel PerfectScript Commands

Use Corel PerfectScript Commands to select, edit, and insert macro commands into a macro. PerfectScript Commands gives you access to application-specific commands (such as commands that function only in Corel Presentations) and commands that are common to all Corel suite applications. The PerfectScript Command Inserter allows you to easily insert product commands into a macro you are building.

Many macro commands use parameters, which are variables used with a command to indicate a specific value or option.

Product commands perform functions that let you use suite applications features in your macros. Many product commands require you to specify parameters and value set members; these give applications information about options to choose in dialog boxes and specify whether certain features (such as the Ruler) should be displayed or hidden. You can use the Command Inserter to specify the commands quickly.

Programming commands allow you to control how application features act and interact. For example, you can use programming commands to request information from the user or specify that part of a macro run several times. The Command Inserter displays the proper syntax of the programming command you select.

When you use the Command Inserter, you can spend less time typing and worrying about spelling errors. You simply choose the commands and parameters you want from the list boxes and insert them into your macro.

For more information on individual macros, select the macro you want from the Commands list box, then right-click the command.

Tips for Macro Commands and Syntax

To insert macro commands

To edit macros

Related Concepts


About Corel PerfectScript Dialog Editor

Use the PerfectScript Dialog Editor to quickly and easily create, design, set properties for, and edit the dialogs you use in your macros. Using the Dialog Editor takes the place of the DialogDefine and DialogAdd sections in your macros.

The Dialog Editor also lets you add, edit, position, size, move, and assign values to controls, lines, and other elements of a dialog. You can use it to give each control a control name, variable name, values, and other properties, as well as define the control order, set the initial focus, set tab stops, and group controls.

For information about controls on any dialog box, click [image], then click a control.

To create new dialogs

To add controls

To save new and edited dialogs in the current macro

Related Concepts


About Playing Macros

Use macros to carry out procedures inside Corel suite applications. You can play, pause, resume, and stop macros. When you play a macro, PerfectScript performs the operations and uses the features you specified in the macro.

For information about controls on the dialog box, click [image], then click a control.

To record macros

To stop macros

To play macros

To pause and resume macros

Related Concepts


About Recording Macros

Use Record, Pause Record, and Stop Record while creating keyboard macros. When you record, PerfectScript keeps track of the actions you perform in an application, such as typing text or saving a file.

For information about controls on the dialog box, click [image], then click a control.

To record macros

Related Concepts


About Compiling Macros

A macro compiler is used to format macros so that applications can play them. This is called compiling. Macros in Corel suite applications are compiled when you play or record them.

If you receive an error message while the macro is compiling, you can choose Cancel Compilation to close the dialog box, or you can choose Continue Compilation to check for other errors that may be in the macro. In either case, the macro will not play. You must correct all errors, then recompile the macro to play it.

For information about controls on the dialog box, click [image], then click a control.

To convert a macro to Corel WordPerfect format

To compile macros

Related Concepts


About Editing Macros

Use the Editor you specified in the Settings dialog box to edit existing macros. You can use any ASCII text editor to edit your macros, but some editors have special features. When you use Notepad, you can also create new macros by typing a new filename. When you use Corel WordPerfect to edit your macros, you can use the PerfectScript Command Inserter from the Macro Property Bar to insert macro commands into your macros or to edit existing ones.

For information about controls on the dialog box, click [image], then click a control.

To generate a listing file for debugging macros

To edit macros

Related Concepts


About Debugging Macros

Use the PerfectScript Debugger to play and compile macros to find errors. You can go straight through macros, step by step, or set specific breakpoints for checking variables.

As the Debugger compiles a macro, it numbers each line of the macro and displays the line numbers of possible problems it encounters as the macro plays. The added lines make the macro a bit larger, but make it possible for you to debug it more easily. In order to see the macro source code in the Debugger, you need to select the "Include debug information" check box on the Compile tab in the Settings dialog box.

Because the compiler does not format the code in your macro the same way a Corel suite application does, you may want to generate a list file when you compile your macro. The list file makes a copy of each procedure and numbers each line, so you can tell which part of the macro corresponds to each line number. It also lists error messages and warnings that came up during the compile at the bottom of the file. Using the list file makes it easy to find and correct errors that the Debugger catches.

For more information about controls on the dialog box, click [image], then click a control.

To edit macros

To generate a listing file for debugging macros

To debug macros

Related Concepts


About Create New Variable

Use Create New Variable to add a new local, global, or persistent variable to the macro you are debugging.

To delete a variable while debugging a macro

To create new variables

Related Concepts


About Settings

Use Settings to select default settings for recording, editing, debugging, compiling, and storing macros.

For information about controls on the dialog box, click [image], then click a control.

To generate a listing file for debugging macros

To choose default macro settings

To select debugging options

To select general macro settings

To select macro recording defaults

Related Concepts


Troubleshooting Macro Problems

The compiler is a useful tool for troubleshooting syntax problems in your macros. If the compiler locates an error, the compiler displays a dialog box containing general information about the problem. The macro compiler, however, can only make a best guess as to what the macro is actually designed to accomplish. As a result, the information the compiler gives sometimes suggests, rather than specifically identifies, the problem.

Some Corel suite applications also have an online macros manual available on the CD. The online manual contains information about macro commands and their syntax, with additional instructions and examples for using macros.

Tips for Macro Commands and Syntax

To choose debugging options for macros

To debug macros

Related Concepts


About the PerfectScript Language

The PerfectScript language is a command-based language. This means that the application records the results of keystrokes or mouse selections instead of recording the keystrokes themselves. For example, instead of recording each keystroke involved in changing the top margin of your document to 2, the application simply records the command MarginTop(2.0). These commands are called product commands.

The PerfectScript language also includes programming commands. These commands let you create macros that can respond to user input.

Example of DialogShow and DialogDismiss

Related Concepts


Tips for Macro Commands and Syntax

If you create macros by recording keystrokes and mouse clicks, the commands are automatically inserted in the correct format.

For macros you type from the keyboard to work properly, macro commands and their elements must be arranged in the correct order. This arrangement is called syntax. To be syntactically correct, each macro command must be spelled correctly and must include all of the required parameters and the necessary separators in the correct order.

Macro commands consist of three parts:  a command name, parameters, and separators.

Command Name

The command name indicates which feature the command activates. Sometimes the name is all that is necessary to perform a complete action. For example, FileOpenDlg() is a complete macro command because Corel WordPerfect does not need any additional information; the command name itself opens the File Open dialog box.

Example:  FileOpenDlg()

Parameters

If the token or command needs more information than is provided by the command name alone, parameters are required. The command name represents the feature. Parameters represent aspects of the feature you can change or selections you can make. For example, the Backup command requires one parameter that indicates whether you want Automatic Document Backup turned on or off. Parameters are always enclosed in parentheses.

Example:  Backup(On!)

Separators

Some macro commands require several parameters. Parameters generally need to be placed in the correct order (except when you specify parameter names) and must be separated properly. Semicolons (;) are used to separate individual parameters, and an entire string of parameters must be enclosed in parentheses. Groups of repeating parameters are also enclosed in braces ({}).

For more information, see Expressions and Variables in the online macros manual. In addition, the Macro Commands Index in the online macros manual for the required syntax and a description of each parameter for all PerfectScript macro commands.

Typing Macro Commands Yourself

Since you do not need to use a macro editor to create or edit Corel WordPerfect macros, you can insert macro commands by typing them in a blank document. When you save a macro, remember to give it a .WCM extension. You can also type commands into a macro thatis saved in a file or in a template.

If you want to improve the readability of a macro, you can format it so that it includes tabs, spaces, and even font or text appearance changes. Formatting the macro will not affect how it works. For example, Corel WordPerfect records the following macro in this format:

PosDocBottom()

Type("Sincerely")

HardReturn()

HardReturn()

HardReturn()

HardReturn()

Type("Ms. Sharon Openshaw")

HardReturn()

Type("Vice President, Marketing")

However, if you type in the commands yourself or edit the existing macro, you can leave spaces between components as follows:

PosDocBottom()

Type ("Sincerely")

HardReturn()

HardReturn()

HardReturn()

HardReturn()

Type ("Ms. Sharon Openshaw")

HardReturn()

Type ("Vice President, Marketing")


To play macros
To play macros,

1	Click File [image] Play.

2	Select the macro you want to play, then click Play.

Tips

You can also play macros by selecting a macro file name in the Explorer, then clicking Play from the QuickMenu.

Related Topics

About Playing Macros


To pause and resume macros
To pause and resume macros,

1	While a macro is playing, click PerfectScript on the Start bar.

2	Select the macro you want to pause, then click the Pause button on the Toolbar.

3	When you want the macro to continue playing, click the Pause button again.

Tips

You can also right-click a macro, then click Pause from the QuickMenu.

Related Topics

About Playing Macros


To stop macros
To stop macros,

1	While a macro is playing, click PerfectScript on the Start bar.

2	Select the macro you want to stop, then click the Stop button on the Toolbar.

Tips

You can also right-click the macro, then click Stop from the QuickMenu.

Related Topics

About Playing Macros


To record macros
To record macros,

1	Click File [image] Record.

2	Type a name for the macro, then click Record.

3	Switch to a Corel suite application or another macro-enabled program, then use it to record keyboard actions in the macro.

4	When you have finished recording the macro, click File [image] Stop Record.

Tips

Press Ctrl+x or Ctrl+Shift+x (where x represents a character a-z or 0-9) to assign your macro to a keystroke combination.

If you need to stop recording temporarily to locate a feature or experiment with the effect of a feature before you record the command, click File [image] Pause Record, then click Pause Record again to continue.

The suite application you are using automatically inserts the Application command when you record a macro. This command tells PerfectScript that, unless otherwise specified, commands with that prefix should be sent to that application and not to another.

Related Topics

About Recording Macros


To compile macros
To compile macros,

1	Click File [image] Compile.

2	Select the macro you want to compile.

Tips

While compiling a macro, you can click File [image] Stop Compile if you need to halt the compile process.

If you are compiling an older macro or one in a different format, you will need to convert it into a more current format.

If your macro references labels and routines not defined inside it, you will get a warning when the compiler reaches that point. As long as the labels and routines are defined in another macro that the current macro calls, there will not be a problem running the macro later.

You can also compile macros by selecting a macro file name in the Explorer, then clicking compile from the QuickMenu.

Related Topics

About Compiling Macros


To edit macros
To edit macros,

1	Click File [image] Edit.

2	Specify the name of the macro you want to edit, then click Edit.

3	If necessary, click Convert to convert the macro for editing.

4	Make the changes you want to the macro, then exit the macro editor.

Tips

Before you can edit a macro, you need to specify a macro editor in the Settings dialog box.

You can also edit macros by selecting a macro file name in the Explorer, then clicking Edit from the QuickMenu.

Related Topics

About Editing Macros


To debug macros
To debug macros,

1	Click File [image] Debug [image] Play.

2	Specify the macro you want to debug.

3	Select the types of variables you want to display.

4	Click Debug [image] Continue to play the macro through, or click a Step option.

5	Correct the errors using the macro editor you selected and the Contents text box for variable values.

Tips

Press Shift+F1, then click a control for specific information.

Related Topics

About Debugging Macros


To exit PerfectScript
To exit PerfectScript,

1	Click File [image] Exit.

Related Topics


To choose default macro settings
To choose default macro settings,

1	Click Tools [image] Settings.

2	To select the default macro folder, set Play Repeat Count, and reset defaults, click the General tab.

3	To select recording format, numbers of parameters, prefixes, and maximum line length, click the Record tab.

4	To select a macro editor and file format, click the Edit tab.

5	To select debugging defaults, click the Debug tab.

6	To show progress during compiling and to select other compiling options, click the Compile tab.

Related Topics

About Settings


To choose recording options for macros
To choose recording options for macros,

1	Click Tools [image] Settings, then click the Record tab.

2	Select the script language and file recording format you want to use.

3	Select the number of parameters you want to appear per line.

4	Specify the maximum line length.

5	Select Named parameters required to force all parameters to have names.

6	Select Record product prefixes on all commands if you want to use product prefixes in macros.

Tips

The file format you select in step 2 should be compatible with the macro editor you select on the Edit tab.

Related Topics

About Settings


To choose a macro editor
To choose a macro editor,

1	Click Tools [image] Settings, then click the Edit tab.

2	Specify the path and filename of the macro editor you want to use.

3	Specify the file format of the editor you selected.

Tips

You must select a macro editor before you can edit macros from PerfectScript, and the file format must match the editor you select.

Related Topics

About Settings


To choose debugging options for macros
To choose debugging options for macros,

1	Click File [image] Debug [image] Play.

2	Select the macro you want to debug.

3	Click Debug [image] Breakpoints, set the breakpoints you want in the macro, then click Close.

4	Click View [image] Variables, then select the types of variables you want to display.

5	Click Variables [image] New to create new variables.

6	Select a variable, then click Variables [image] Delete to remove it.

7	Click Debug [image] Continue to play the macro through, or click a Step option.

Related Topics

About Debugging Macros


Tips for Linking Dialogs to Macros

Use the DialogShow and DialogDismiss commands to use a dialog created in the PerfectScript Dialog Editor within a macro. These commands can be found in the PerfectScript Command Inserter under the type PerfectScript.

The DialogShow command uses three parameters:  the dialog name, the parent window for the dialog, and a label that identifies a callback function. The first and second parameters are required, the third is optional. The DialogDismiss command requires two parameters:  the name of the dialog and the name of the control used to dismiss the dialog. See the Example cited in the Related Topics list for syntax and further information.

Variables associated with controls work the same way as with the DialogDefine method. If a variable exists, its value is set into the controls when the dialog displays, and the value in the controls is set into the variables when the dialog is dismissed.

Before a you can use a region command to manipulate a dialog, that dialog must be loaded into memory. DialogShow loads the dialog into memory and displays it. (The DialogLoad command loads the dialog into memory but does not display it.) Because a dialog must be loaded before you can use it, be sure to use a DialogShow (or DialogLoad) command before you use any Region commands.

Related Topics

About Corel PerfectScript Dialog Editor


To create new variables
To create new variables,

1	Click File [image] Debug [image] Play.

2	Select a macro you have compiled for debugging, then click Play.

3	When the debugger stops at the place you want to add a variable, click Variables [image] New.

4	Type a name for the variable, click a variable type, then click Create.

About Create New Variable


About Using the Grid to Design Dialogs

Use the options on the View menu to align controls with precision. By displaying a grid of dotted lines on your dialog, you can neatly position and line up controls. You can also force controls to stick to grid lines with Snap to Grid and select grid spacing intervals for even greater precision placement.

To align and space controls

To position controls with a grid

Related Concepts


About Testing a Dialog

Use Test to check your dialogs before closing the PerfectScript Dialog Editor. Testing a dialog lets you check its controls to make sure they appear and function correctly before you close the Dialog Editor. When you are finished testing, click an OK or Cancel button, or click the Close button on the dialog's title bar.

To save new and edited dialogs in the current macro

To create new dialogs

Related Concepts


About Font

Use Font to choose a typeface and point size for all text on your dialog. The caption font remains constant for all dialogs. Changes in font size and style do affect the size of the dialog.

To choose fonts for dialogs

Related Concepts


About Control Order

Use Control Order to specify the sequence in which you want to tab through the controls. You must set the control order before grouping the controls.

To set up dialogs

Related Concepts


About Control Groups

Use Control Groups to group controls together. Defining a group box around a set of controls does not group them, and you must set the control order before grouping controls.

To set up dialogs

Related Concepts


About Default Button

Use Default Button to specify the button you want to be activated when the user presses Enter on the control.

To set up dialogs

To add controls

Related Concepts


About Initial Focus

Use Initial Focus to specify the control that has the focus when the dialog opens.

To set up dialogs

Related Concepts


About Tab Stops

Use Tab Stops to select the controls you want to tab to.

To set up dialogs

Related Concepts


About Bitmap

Display a bitmap as a control. The bitmap appears on the background of the dialog without a border. You can use horizontal and vertical lines to outline it for clarity.

A bitmap control looks like this:

Use the Properties dialog to set the location, size, named regions, variables, and other properties for the control.

For information about controls on the dialog box, click [image], then click a control.

To add controls

To edit controls

To delete controls

Related Concepts


About Buttons

There are several different kinds of buttons you can add to a dialog box.

Pop-up buttons display a list of options when clicked. The button itself shows the selected option. A pop-up button looks like this when it is closed [image], and like this [image] when you click it.

A push button activates a specific action when clicked, such as OK, Cancel, Help, and so on. A push button looks like this:

Radio buttons represent mutually exclusive options. Selecting one radio button deselects another. A radio button looks like this:

Use the Properties dialog to set the location, size, named regions, variables, and other properties for each control.

For information about controls on the dialog box, click [image], then click a control.

To add controls

To edit controls

To delete controls

Related Concepts


About Check Box

Check boxes represent compatible options. Clicking an empty check box selects the option; clicking a marked check box deselects the option. You can also define check boxes as "Three State" to give a third value, where a box is checked and grayed to be unavailable.

A check box looks like this:

Use the Properties dialog to set the location, size, named regions, variables, and other properties for the control.

For information about controls on the dialog box, click [image], then click a control.

To add controls

To edit controls

To delete controls

Related Concepts


About Color Wheel

Color wheels allow users to select colors based on values of hue, lightness, and saturation.

A color wheel looks like this:

Use the Properties dialog to set the location, size, named regions, variables, and other properties for the control.

For information about controls on the dialog box, click [image], then click a control.

To add controls

To edit controls

To delete controls

Related Concepts


About Combo Box

Combo boxes display an edit box and a list box. Enter text in the edit box, or double-click a list item to insert it.

A combo box looks like this [image] when it is closed and like this [image] when you click it.

Use the Properties dialog to set the location, size, named regions, variables, and other properties for the control.

For information about controls on the dialog box, click [image], then click a control.

To add controls

To edit controls

To delete controls

Related Concepts


About Counter

Counters allow users to enter numeric data in an edit box by typing or by clicking an incrementor/decrementor. Clicking inserts a number in the edit box that is within a specified range.

A counter looks like this:

Use the Properties dialog to set the location, size, named regions, variables, and other properties for the control.

For information about controls on the dialog box, click [image], then click a control.

To add controls

To edit controls

To delete controls

Related Concepts


About Custom

Custom controls let you specify your own options for text, class, and attributes.

A custom control looks like this:

Use the Properties dialog to set the location, size, named regions, variables, and other properties for the control.

For information about controls on the dialog box, click [image], then click a control.

To add controls

To choose control properties

To edit controls


About Date

Date controls display an edit box and a calendar icon. Users can enter dates by typing or by clicking the calendar icon to open a calendar and selecting a date to display in the edit box.

A date control looks like this when you click the calendar icon:

Use the Properties dialog to set the location, size, named regions, variables, and other properties for the control.

For information about controls on the dialog box, click [image], then click a control.

To add controls

To edit controls

To delete controls

Related Concepts


About Edit Box

Edit boxes allow users to type text or allow the macro to type text for them. They can have one line or multiple lines.

An edit box looks like this:

Use the Properties dialog to set the location, size, named regions, variables, and other properties for the control.

For information about controls on the dialog box, click [image], then click a control.

To add controls

To edit controls

To delete controls

Related Concepts


About Filename Box

Filename boxes display an edit box and a folder icon list button. Users can enter filenames or directories by typing them in or by clicking the list button to display a Browse dialog.

A filename box looks like this:

Use the Properties dialog to set the location, size, named regions, variables, and other properties for the control.

For information about controls on the dialog box, click [image], then click a control.

To add controls

To edit controls

To delete controls

Related Concepts


About Frame

Frames can visually group items in a dialog, or act as design elements.

A frame looks like this:

Use the Properties dialog to set the location, size, named regions, variables, and other properties for the control.

For information about controls on the dialog box, click [image], then click a control.

To add controls

To edit controls

To delete controls

Related Concepts


About Group Box

Group boxes visually group controls in a dialog with a titled frame. Group boxes do not automatically group the controls, however. Use Control Groups and Control Order to group controls.

A group box looks like this:

Use the Properties dialog to set the location, size, named regions, variables, and other properties for the control.

For information about controls on the dialog box, click [image], then click a control.

To add controls

To edit controls

To delete controls

Related Concepts


About Lines

Horizontal and vertical lines visually separate items in a dialog.

A horizontal line looks like this:

A vertical line looks like this:

Use the Properties dialog to set the location, size, named regions, variables, and other properties for the control.

For information about controls on the dialog box, click [image], then click a control.

To add controls

To edit controls

To delete controls

Related Concepts


About List Box

List boxes display lists of options to choose from.

A list box looks like this:

Use the Properties dialog to set the location, size, named regions, variables, and other properties for the control.

For information about controls on the dialog box, click [image], then click a control.

To add controls

To edit controls

To delete controls

Related Concepts


About Progress Indicator

Progress indicators display the progress of a process as it runs.

A progress indicator looks like this:

Use the Properties dialog to set the location, size, named regions, variables, and other properties for the control.

For information about controls on the dialog box, click [image], then click a control.

To create new dialogs

To edit controls

To delete controls

Related Concepts


About Scroll Bars

Scroll bars allow users to scroll from left to right and top to bottom.

A vertical scroll bar looks like this:

A horizontal scroll bar looks like this:

Use the Properties dialog to set the location, size, named regions, variables, and other properties for the control.

For information about controls on the dialog box, click [image], then click a control.

To add controls

To edit controls

To delete controls

Related Concepts


About Static Text

Static text on a dialog gives instructions or information to users. Static text can consist of one line or many lines, and is read-only.

Static text looks like this:

Use the Properties dialog to set the location, size, named regions, variables, and other properties for the control.

For information about controls on the dialog box, click [image], then click a control.

To add controls

To edit controls

To delete controls

Related Concepts


About Viewer

Viewers display read-only, scrollable text files.

A viewer looks like this:

Use the Properties dialog to set the location, size, named regions, variables, and other properties for the control.

For information about controls on the dialog box, click [image], then click a control.

To add controls

To edit controls

To delete controls

Related Concepts


About Aligning Controls

Use the Location and Size options on the Properties dialog box to position and size controls precisely using dialog units. You can also click and drag to size and position controls manually.

Use the options on the Align menu to position and space controls inside the dialog and in relation to each other. The last control you click is the "anchor control," which appears with black squares around it.

To align and space controls

To edit controls

To add controls

To delete controls

Related Concepts


About Center

Use Center to center a control in relation to the anchor control. Press Shift to select multiple controls. The last control you select is the anchor control, and all the selected controls will be centered in relation to it. You can also press Ctrl while selecting a control to center a copy of it.

To align and space controls

Related Concepts


About Make Same Size

Use Make Same Size to make a selected control the same size as the anchor control. Press Shift to select multiple controls. The last control you select is the anchor control, and all the selected controls will be made the same size as it is.

To choose control properties

To add controls

Related Concepts


About Space Evenly

Use Space Evenly to space controls horizontally or vertically inside the dialog and in relation to each other.

To align and space controls

Related Concepts


To open the PerfectScript dialog editor from Corel WordPerfect
To open the PerfectScript dialog editor from Corel WordPerfect,

1	Click Tools [image] Macro [image] Edit.

2	Select a macro filename, then click Edit to display the Macro toolbar.

3	Click Dialog Editor on the macro toolbar.

4	Select the dialog you want, then click Edit.

Related Topics

About Corel PerfectScript Dialog Editor


To display a dialog within your macro
To display a dialog within your macro,

1	In your macro editor, type or insert the DialogShow command where you want the dialog to appear in your macro.

2	Specify the name of the dialog and the named region for its parent window.

3	Specify a callback parameter if you want the macro to execute while the dialog displays.

4	Type or insert the DialogDismiss command after a DialogShow command that uses callback.

5	Specify the name of the dialog and the name of the control used to dismiss the dialog.

Related Topics

About Corel PerfectScript Dialog Editor


To dismiss a dialog if you are using a callback
To dismiss a dialog if you are using a callback,

1	In your macro editor, type or insert the DialogDismiss command after a DialogShow command that uses a callback.

2	Specify the name of the dialog and the name of the control used to dismiss the dialog.

Tips

If you use a cancel button, a control other than a push-button, or a non-existent control to dismiss the dialog, your changes will not take effect. If you use a push-button other than a cancel button, the variable values are set and your changes take effect when you dismiss the dialog.

Related Topics


Example of DialogShow and DialogDismiss

The following is an example of the DialogShow command:

DialogShow("DialogName";"WordPerfect";CallBack@)

The first parameter is the name you gave to the dialog when you created it in the PerfectFit Dialog Editor (in this case, DialogName).

The second parameter is a named region specifying the parent window for the macro dialog (in this case, the Corel WordPerfect window will be the parent window for the dialog). Named regions are defined by the application. The region consists of the application name, followed by a period (.), followed by additional words that narrow the named region to the appropriate window. For example, the named region of the document window in Corel WordPerfect is WordPerfect.Document.

The third parameter is a label that identifies a callback function. If you do not specify a callback parameter in the DialogShow command, the macro does not execute until you dismiss the dialog. If you use a callback, the macro executes while the dialog is up. It is up to the callback to prevent the macro from terminating prematurely and to shut down the macro dialog using the DialogDismiss command.

The following is an example of the DialogDismiss command:

DialogDismiss("DialogName";"OKBttn")

The first parameter is the dialog name.

The second parameter is the named region of the control used to dismiss the dialog.

For more information on the DialogShow and DialogDismiss commands, see Macros Online Help.

Related Topics

About Corel PerfectScript Dialog Editor


To select macros and dialogs for editing
To select macros and dialogs for editing,

1	Click Tools [image] Dialog Editor.

2	Select the macro file(*.wcm) you want to create or edit dialogs for, then click OK.

3	Select the dialog you want to edit, or click File [image] New to add a new dialog to the macro.

Tips

The PerfectScript Dialog Editor works only with macros in Corel WordPerfect format. The Dialog Editor does not allow you to edit the macros themselves, only to define dialogs for them.

About Corel PerfectScript Dialog Editor


About Setting Up Dialogs

Use the options on the Dialog menu to group dialog controls, to specify the default focus and buttons, and to define tab stops. You must set the control order before grouping the controls; defining a group box around a set of controls does not automatically group them.

For information about controls on any dialog box, click [image], then click a control.

To set up dialogs

To add controls

Related Concepts


To create new dialogs
To create new dialogs,

1	Click Tools [image] Dialog Editor.

2	Select the macro you want to add a dialog to, then click OK.

3	Click File [image] New.

4	Type a name for the new dialog, then click File [image] Open to edit the dialog.

5	Add controls, choose a font, and set the properties for the dialog.

6	Click File [image] Save to save the new dialog in the current macro file, then click File [image] Close to exit the dialog.

Tips

Be sure to use the same names for the dialogs that you used in your macros, with the same case, since dialog and control names are case-sensitive.

Related Topics

About Corel PerfectScript Dialog Editor


To edit dialogs
To edit dialogs,

1	Click Tools [image] Dialog Editor.

2	Select the macro file containing the dialog you want to edit, then click OK.

3	Double-click the dialog you want to edit.

4	Add, edit, or delete controls, change the font, and alter the properties for the dialog.

5	Click File [image] Save to save the edited dialog in the current macro file.

Related Topics

About Corel PerfectScript Dialog Editor


To copy dialogs
To copy dialogs,

1	Click Tools [image] Dialog Editor.

2	Select the macro you want, then click OK.

3	Select the dialog you want to copy.

4	Click Edit [image] Copy.

5	Open the macro file you want to copy the dialog to, then click Edit [image] Paste.

6	Select the copy, click File [image] Rename, then type a new name for the dialog.

Tips

Copy places an exact copy of a dialog in another macro file or in the current macro file.

Related Topics

About Corel PerfectScript Dialog Editor


To delete dialogs
To delete dialogs,

1	Click Tools [image] Dialog Editor.

2	Select the macro you want, then click OK.

3	Select the dialog you want to delete.

4	Click File [image] Delete.

5	Click Yes.

Tips

Delete removes a dialog from a macro file, but you must also delete all references to a deleted dialog from the macro itself using your selected macro editor.

Related Topics

About Corel PerfectScript Dialog Editor


To rename dialogs
To rename dialogs,

1	Click Tools [image] Dialog Editor.

2	Select the macro you want, then click OK.

3	Select the dialog you want to rename.

4	Click File [image] Rename.

5	Type a new name for the dialog.

Tips

Renaming gives a dialog a new name while leaving it in the current macro file, but it does not change the name displayed on the caption bar.

When you rename a dialog, you will need to change all references to it in the macro itself using your selected macro editor.

Related Topics

About Corel PerfectScript Dialog Editor


To save new and edited dialogs in the current macro
To save new and edited dialogs in the current macro,

1	Click Tools [image] Dialog Editor.

2	Select the macro you want, then click OK.

3	Double-click the name of an existing dialog, or click File [image] New to create a dialog.

4	Add, edit, or delete controls, choose the font, and set the properties for the dialog.

5	Click File [image] Save, then click File [image] Close when you are finished with the dialog.

Related Topics

About Corel PerfectScript Dialog Editor


To test dialogs before closing the Dialog Editor
To test dialogs before closing the Dialog Editor,

1	Click Tools [image] Dialog Editor.

2	Select the macro you want, then click OK.

3	Double-click the name of an existing dialog, or click File [image] New to create a dialog.

4	Add, edit, or delete controls, choose the font, and set the properties for the dialog.

5	Click Dialog [image] Test.

6	Use each control on the dialog, and make changes as needed.

7	When you are finished testing, click File [image] Save, then click File [image] Close.

Related Topics

About Testing a Dialog


To choose dialog properties
To choose dialog properties,

1	Click Tools [image] Dialog Editor.

2	Select the macro you want, then click OK.

3	Double-click the name of an existing dialog, or click File [image] New to create a dialog.

4	Right-click the dialog, then click Properties from the QuickMenu.

5	Specify the location, size, caption, help file and help key, attributes, dialog type, and frame for the dialog.

Related Topics

About Properties


To choose fonts for dialogs
To choose fonts for dialogs,

1	Click Tools [image] Dialog Editor.

2	Select the macro you want, then click OK.

3	Double-click the name of an existing dialog, or click File [image] New to create a dialog.

4	Click Dialog [image] Font.

5	Select a font and point size.

Tips

The font size you choose will affect the size of your dialog--larger font means larger dialog area.

Related Topics

About Font


About the Control Toolbar

Use the Control toolbar to choose controls and actions in the PerfectScript Dialog Editor.

To add controls

Related Concepts


To add controls
To add controls,

1	Click Tools [image] Dialog Editor.

2	Select the macro you want, then click OK.

3	Double-click the name of an existing dialog, or click File [image] New to create a dialog.

4	Click Control, then click the control you want to add.

5	Position the "x" above the control symbol where you want the top-left corner of the control to appear, then click.

6	Double-click the control, set its properties, then click OK.

7	Repeat steps 4-6 for the rest of the controls you want to add.

Tips

You can also add controls using the icons on the toolbar.

Related Topics

About the Control Toolbar


To delete controls
To delete controls,

1	Click Tools [image] Dialog Editor.

2	Select the macro you want, then click OK.

3	Double-click or create a dialog with controls on it.

4	Select the control you want to delete, then press Del.

Related Topics

About Corel PerfectScript Dialog Editor


To edit controls
To edit controls,

1	Click Tools [image] Dialog Editor.

2	Select the macro you want, then click OK.

3	Double-click the name of an existing dialog, or click File [image] New to create a dialog.

4	Select the control you want to edit.

5	Double-click the control, make the changes you want to its properties, then click OK.

6	Click and drag each control to position and size it.

Related Topics

About Corel PerfectScript Dialog Editor


To position multiple controls
To position multiple controls,

1	Click Tools [image] Dialog Editor.

2	Select the macro you want, then click OK.

3	Double-click or create a dialog with controls in it.

4	Click the top left corner of the top control in the group you want to select.

5	Drag the selection area down and right to select all the controls you want in the group.

6	Drag the grouped controls to position them.

Tips

You can also hold down Shift while clicking controls to select multiple controls.

Related Topics

About Corel PerfectScript Dialog Editor


To position single controls
To position single controls,

1	Click Tools [image] Dialog Editor.

2	Select the macro you want, then click OK.

3	Double-click or create a dialog with controls in it.

4	Double-click a control, specify a left and top value to position it on the dialog, specify a width and height value to change its size, then click OK.

Tips

You can also click and drag each control to position and size it.

Related Topics

About Corel PerfectScript Dialog Editor


To choose control properties
To choose control properties,

1	Click Tools [image] Dialog Editor.

2	Select the macro you want, then click OK.

3	Double-click or create a dialog with controls in it.

4	Double-click a control, then make the changes you want to its properties.

Tips

You can also click and drag controls to position and size them.

Related Topics

About Properties


To set up dialogs
To set up dialogs,

1	Click Tools [image] Dialog Editor.

2	Select the macro you want, then click OK.

3	Double-click or create a dialog with controls in it.

4	Click Dialog [image] Control Order, click the controls in the order you want to tab through them, then click OK.

5	Click Dialog [image] Control Groups, click each control to select its group, then click OK.

6	Click Dialog [image] Default Button, click a control, click the button you want to be activated when the user presses Enter on the control, then click OK.

7	Click Dialog [image] Initial Focus, click the control you want to have the focus when the dialog displays, then click OK.

8	Click Dialog [image] Tab Stops, click to highlight the controls you want to tab to, then click OK.

Related Topics

About Setting Up Dialogs


About Properties

Use Properties to specify the location and size of the dialog, its caption, class, dialog type, frame type, and attributes.

Use the Properties dialogs associated with each control to set the location, size, named regions, variables, and other properties for each control.

For information about controls on the dialog box, click [image], then click a control.

To choose control properties

To add controls

To create new dialogs

To choose dialog properties

Related Concepts


To copy controls
To copy controls,

1	Click Tools [image] Dialog Editor.

2	Select the macro you want, then click OK.

3	Double-click or create a dialog with controls on it.

4	Select the control(s) you want to copy.

5	Right-click, then click Copy from the QuickMenu.

6	Drag the copy to position it.

Tips

The copy has all the properties of the original control. Double-click the new control to change them.

You can also press Ctrl while selecting to copy a control.

Related Topics

About Properties


To add and edit list items
To add and edit list items,

1	Double-click a control that uses a list of options.

2	Click Create/Edit List.

3	Type a name, then choose Add for each option in the list.

4	Select an item in the list, type a new name, then click Replace to edit an item.

5	Select an item in the list, then click Move Up or Move Down to reposition an item.

6	Select an item on the list, then click Delete to remove list items.

7	Select an item in the list, then click Set Initial to have that item selected when the dialog opens.

Tips

You can also select the Sort list check box to sort the list items alphabetically. When Sort list is selected, you can not rearrange items in the list.

Related Topics

About Create/Edit List


About Create/Edit List

Use Create/Edit List to enter and change options for controls that use lists, such as pop-up lists, drop-down lists, list boxes, and so on.

For information about controls on the dialog box, click [image], then click a control.

To add and edit list items

To create new dialogs

Related Concepts


To position controls with a grid
To position controls with a grid,

1	Click Tools [image] Dialog Editor.

2	Select the macro you want, then click OK.

3	Double-click or create a dialog with controls in it.

4	Click View [image] Show Grid.

5	Click View [image] Snap to Grid to force controls to align with grid points.

6	Click View [image] Grid Options, specify the amount of space you want between grid points on each axis, then click OK.

7	Add controls to the dialog using the grid as a guide.

Related Topics

About Using the Grid to Design Dialogs


To align and space controls
To align and space controls,

1	Press Shift while clicking the control(s) you want to align with each other, then click Align [image] Left, Right, Top, or Bottom to move the control to that side of the anchor control.

2	Press Shift while clicking the control(s) you want to align with each other, then click Align [image] Center [image] Vertical or Horizontal to center a control in relation to the anchor control.

3	Press Shift while clicking the control(s) you want to make the same size as the anchor control, then click Align [image] Make Same Size [image] Vertical, Horizontal, or Both.

4	Press Shift while clicking the controls you want to space in relation to each other, then click Align [image] Space Evenly [image] Vertical or Horizontal.

Tips

The anchor control is the last control you select.

Related Topics

About Aligning Controls


To select general macro settings
To select general macro settings,

1	Click Tools [image] Settings, then click the General tab.

2	Specify a default macro folder.

3	Specify a Play Repeat Count.

4	Select Use PerfectFit open dialog box if you want to use the common Corel suite Open dialog instead of the Windows open dialog.

.Tips

Click Reset All to Defaults to return all settings to their original state.

Related Topics

About Settings


To select macro recording defaults
To select macro recording defaults,

1	Click Tools [image] Settings, then click the Record tab.

2	Select the script and file formats in which you want to save your macro.

3	Click One or Multiple from the Parameters per line drop-down list to set the number of parameters for each line in your macro.

4	Specify a maximum line length for your macro text.

5	Select Named parameters required to use only named parameters in your macros.

6	Select Record product prefixes on all commands if you want to insert product prefixes in your macros.

Related Topics

About Settings


To generate a listing file for debugging macros
To generate a listing file for debugging macros,

1	Click Tools [image] Settings, then click the Compile tab.

2	Select Generate listing file, then click OK.

3	Click File [image] Debug [image] Compile.

4	Select the macro you want to compile, then click Open.

Tips

The list file has the same name as the original macro, with a .WCL extension. Use any ASCII text editor to display the list file, so you can see which lines in your macro correspond to which line numbers.

Related Topics

About Debugging Macros


To select debugging options
To select debugging options,

1	Click Tools [image] Settings, then click the Debug tab.

2	Select the options you want to use for invoking the debugger.

3	Select the options you want to use for recording debugging information during compiling.

4	Set your animation options.

Tips

Animation allows you to step through macros line by line, automatically bringing up the debugging dialog box at each step so you can check the variables and other calls. You can specify how long the Debugger will pause before moving to the next step. Clicking inside the Debugger halts the animation, as do any breakpoints you have specified. Click Debug [image] Animate to resume automatic play.

Related Topics

About Settings


About Convert Macro to Corel WordPerfect Format

Use Convert Macro to Corel WordPerfect Format to convert a macro to a format your Corel suite applications can use. You can replace the macro or save it under a different filename or in a different directory.

For information about controls on the dialog box, click [image], then click a control.

To convert a macro to Corel WordPerfect format


To convert a macro to Corel WordPerfect format
To convert a macro to Corel WordPerfect format,

1	Click File [image] Play.

2	Select the macro you want to convert.

3	Specify a path and filename for the converted macro.

About Convert Macro to Corel WordPerfect Format


Tips for Locating Applications

When you play a macro, PerfectScript checks the Registry for the path to the application's .EXE. If the location is not in the Registry, PerfectScript asks you to specify the location of the application's .EXE.

1	Select the macro you want to play, then click Play.

2	Specify the location of the .EXE file for the application.

For information about controls on the dialog box, click [image], then click a control.

Related Topics


To insert macro commands
To insert macro commands,

1	Click File [image] Edit.

2	Select the macro you want to work on, then click Edit.

3	Move the insertion point to the place in the macro where you want to insert the commands.

4	Click Commands on the Macro Feature bar to open the Command Inserter.

5	Select the type of command you want to insert, then select and double-click a command.

6	Select a parameter, type in or select the value for the parameter, then click Update.

7	Double-click enumerations to add both the parameter and enumerations.

8	Click Insert to place the new command in the macro.

Tips

You can edit a parameter by selecting the parameter and changing its value in the Command Edit text box.

Before you can use the Command Inserter, use the Edit tab on the Settings dialog box to specify Corel WordPerfect as the default macro editor.

If you are using the Command Inserter with that has a Parameter Value text box, you can select the command to insert, then type in a value for the parameter. Clicking Value lets the application automatically insert a value for the parameter, and clicking Update changes the display to reflect the new value.

Related Topics

About Corel PerfectScript Commands


About Breakpoints

You can specify the conditions under which you want the debugger to stop the macro as it plays and bring up the Debugger dialog box. You can make the macro stop at any line, .DLL call, or other place in a macro. The Debugger dialog will then display the labels, functions, procedures, variables being passed, and so on, so you can check them.

The Debugger automatically creates three breakpoints: Macro Start, Macro End, and Error. It marks the breakpoints it adds with an !, and you can remove these if you wish to.

These are the types of breakpoints you can use:

DLL Call: Breaks when your macro calls a .DLL file.

Error: Breaks when an error occurs while running the macro.

Label Call: Breaks when a label or user-defined routine comes up in the macro. Everything that is not specifically contained in a routine or label is in the <main> routine.

Label Return: Breaks when a label or user-defined routine comes up in the macro, but stops before executing the return from the label call.

Line Number: Breaks when the macro reaches a line number you specify.

Macro End: Breaks at the end of the macro.

Macro Start: Breaks at the start of the macro.

For information about controls on the dialog box, click [image], then click a control.

To specify where you want the debugger to stop while playing a macro

Related Concepts


To specify where you want the debugger to stop while playing a macro
To specify where you want the debugger to stop while playing a macro,

1	Click File [image] Debug [image] Play.

2	Specify the macro you want to play with the Debugger.

3	When the Debugger dialog box opens, click Debug [image] Breakpoints.

4	Select the type of breakpoint you want to use, then click Add.

5	Specify the options you want to use for the type of breakpoint you added, then click Update.

Tips

Each type of breakpoint has different options. Press Shift+F1, then click a control for specific information.

Related Topics

About Breakpoints


To create and edit variables in your macro
To create and edit variables in your macro,

1	Click File [image] Debug [image] Play.

2	Specify the macro you want to debug.

3	Select the types of variables you want to display.

4	Select a variable, or double-click an array, then select a variable within it.

5	Edit the contents of the variable, then click Update.

6	Click Variables [image] New, type a name for the new variable, then click a variable type to add a variable to the macro.

7	Click Variables [image] Delete to remove a variable.

Tips

The Variables list displays all of the variables defined at the current step in the macro. As you click on the entries in the label, function, or procedure list, the variables in the list change, displaying the local variables defined in each step.

Updating the value of a variable that is an alias for another variable changes the original value, and all other aliases will reflect the new value.

Related Topics

About Debugging Macros


About Discard Variable

Use Discard Variable to remove a variable while debugging a macro. You can delete the variable from the Variables list box, or you can remove the contents of the variable but leave in the Variables list box.

To delete a variable while debugging a macro

Related Concepts


To delete a variable while debugging a macro
To delete a variable while debugging a macro,

1	Click File [image] Debug [image] Play.

2	Step through the variable until the variable you want to discard appears in the Variables list box.

3	Click the variable name.

4	Click Variables [image] Delete.

5	Click the discard option you want.

Related Topics

About Discard Variable


About Event Log

The Event Log displays any event that occurs during debugging. These messages include standard messages ("Debugger event logging enabled") and custom messages for which you supply the comment.

To enable event logging, click Debug [image] Breakpoints, then click the Actions tab. You can log standard and custom messages, which will then appear in the Event Log.

To make a debugger log file


To make a debugger log file
To make a debugger log file,

1	Click Debug [image] Breakpoints, then click the Action tab.

2	Select the types of events you want to enter into the log file, then click Close.

3	Start the debugger, then click View [image] Event Log.

4	Select Logging enabled.

5	Click Save, then specify a path and filename for your event log.

Tips

Your event log is a text file with a default .log extension.

About Event Log


About Corel Web Site

If you have installed Netscape Navigator or another browser, and have a modem or network connection to an Internet service provider, you can click Help [image] Corel Web Site and go to the Corel home page for this suite.

The home page contains links to:

Reference Center, where you can download software manuals and system administration information in Envoy format, as well as other valuable information

Technical Information Documents from Customer Services

Hints and tips, demos, and other task-oriented resources

If you have installed CompuServe software and have a modem or network connection to a CompuServe account, you can go to the users' forum for this suite.

The first time you use this feature, click Configure to set up either the Netscape Navigator to point to the Documentation home page or CompuServe to point to the users' forum.

Related Concepts


Specify the justification (left, center, or right) for group box titles.


Specify the text associated with the edit box.


Put a title bar and caption on the dialog.


Put a system menu on the dialog.


Select the types of scrolling the edit box allows beyond its edges. Vertical scrolling allows text to scroll up and down. Horizontal scrolling allows text to scroll left and right.


Size the control to make it as large or small as the bitmap.


Size the bitmap to make it fit on the control.


Do not size either the control or the bitmap. If the bitmap is bigger than the control, the edges are cropped.


Select the state of the radio button when the dialog opens. Clear leaves the radio button unmarked and unactivated. Checked marks the radio button with a dark circle and leaves it activated.


Specify the text appearing on a push or pop-up button, or beside a radio button.


Select how text appears in the edit box (upper, lower, or mixed case).


Specify the text that appears in the title bar of the dialog. If you type a title longer than the title bar, it is cut off at the right edge.


Specify the text that appears next to the check box.


Create a check box that gives two possible states (on or off). When users click on the check box, it automatically changes the state. No additional message is necessary in the macro. This is the most commonly used type.


Create a check box that gives two possible states (on or off). When users click on the check box, it does not automatically reflect the change. You must send a message to the dialog within the macro to change the state of the check box.


Create a check box that gives three possible states (on, off, or indeterminate). When users click on the check box, it does not automatically reflect the change. You must send a message to the dialog within the macro to change the state of the check box.


Create a check box that gives three possible states (on, off, or indeterminate). When users click on the check box, it automatically changes the state. No additional change is necessary in the macro.


Specify the dialog class.


Allow users to enter text longer than the actual combo box without cutting it off.


Convert text typed in the control from the Windows character set to the OEM character set, then back to the Windows character set again. This ensures proper character conversion.


Create a combo box as a small, permanently open list with a thin, black border.


Create a combo box as a small list with a thin, black border when the user clicks the icon next to the edit control. A scroll bar appears if the number of items in the list exceeds the length of the list box.


Create a combo box as a static text field displaying the current selection instead of an edit control. Clicking the control displays the list. A scroll bar appears if the number of items in the list exceeds the length of the list box.


Accept or cancel changes the user made to the dialog box.


Allow users to enter numbers longer than the actual counter text box without cutting them off.


Automatically check entered numbers to ensure they fall within the acceptable range, and change unacceptable numbers to the nearest acceptable value when the user leaves the control.


Remove the incrementor/decrementor buttons.


Specify the minimum value possible for the counter.


Specify the maximum value possible for the counter.


Specify the increment the counter's incrementor/decrementor buttons use. For example, typing 5 causes each click on the Up arrow to increase the value in the text box by 5: 5, 10, 15, 20, and so on.


Specify the value the counter displays when the dialog opens.


Specify the unit the counter measures (i.e., centimeters, inches, points, and so on).


Specify the list of possible choices. Click Create/Edit List to add, replace, delete, and position items on the list, and to set the option selected when the dialog opens.


Automatically check entered dates to ensure they fall within the acceptable range, and keep the focus on the control until the user enters an admissible date and format.


Create a dialog that a user must dismiss to access features in the parent window. You can switch to another window using Alt+Tab.


Create a dialog that a user can leave open and still access features in the parent window.


Create a dialog that the user must dismiss before accessing any other functions.


Allow users to press Return inside the edit box to enter multiple lines.


Display characters as asterisks as the user types a password.


Display text the user cannot edit.


Allow text to wrap to the next line when it reaches the right edge of the text box.


Specify the sides of the edit box on which scroll bars appear. Use scroll bars with edit boxes to let the user see all the text entered.


Limit text entry to a single line in the edit box. Pressing Return moves the user to the next control.


Allow users to enter multiple lines of text in the edit box.


Limit text entry to the number of characters you specify. The system limit is 1 K.


Specify the path and filename of the bitmap image you want to use. Use the browse icon to select paths and filenames.


Display only folder and subfolder names in the browse list; all filenames are grayed.


Display folders, subfolders, and filenames in the browse list.


Allow users to enter invalid filenames without generating an error message.


Use with Path Only. Allow users to enter invalid paths and to create the folder or subfolder.


Specify the default folder and template for filename boxes. Click the folder icon to select folders.


Select a white, black, or gray fill and border for frames.


Remove the frame from around the dialog.


Put a thin black line around the dialog.


Put a Windows-standard dialog border around the dialog.


Put a thick border around the dialog with sizing areas on the corners and edges.


Select the type of frame you want to use. Using frames does not automatically group controls. Select Filled to fill the area inside the frame with a solid color. Select Frame to outline the area with a thin line.


Specify the Help file and Help key this dialog connects to. For example, you can tell this dialog to look for "MYHELP.HLP" and assign it a key included in the map and alias files for that Help system.


Select the buttons displayed on the dialog that appear when users click the folder icon. You must have these applications and options available in order for them to operate.


Display a button that opens QuickFinder*.


Display a button that opens a dialog allowing users to change the appearance of the dialog.


Display a button that allows users to view files.


Display a button that allows users to copy, rename, delete, and otherwise manipulate files.


Specify the values for the color highlighted when the dialog opens. You can also click the color wheel and color bar to select colors.


Adjust the color (0=red, 240=blue, 360=green).


Adjust the amount of white and gray in a color.


Adjust the amount of color.


Specify the date displayed when the dialog opens. Click the calendar icon to select the date, or specify today's date.


Create a check box that is unmarked and unactivated when the dialog opens.


Create a check box that is marked with an X and activated when the dialog opens.


Create a check box that is filled with gray as the dialog opens. You must select Three-State or Auto Three-State from the type group box to activate this option.


Specify the justification (left, center, or right) for text inside edit boxes.


Display check boxes next to each item in a list box.


Allow users to select several separated items in the list box by pressing Ctrl while clicking.


Allow users to select contiguous items in a list box by dragging over them.


Precisely position a control in relation to the top-left corner of the dialog. The values you can use depend on the size of the dialog and are measured in dialog units. You can also select and drag controls to position them.


Record any events that occur during debugging.


These are the events that occurred during debugging, including the time and date.


Position the dialog in dialog units from the top-left corner of the parent window. Dialog units are based on the currently selected font for the dialog and on your screen resolution.


Position the dialog based on available screen space. For example, if you choose 50% for Left and 50% for Top, 50% of the available screen space will be on the left and 50% will be at the top of the dialog.


Specify the percent or number of dialog units the dialog is removed from the left edge of the window.


Specify the percent or number of dialog units the dialog is removed from the top edge of the window.


Specify the width of the dialog in dialog units. Dialog units are based on the currently selected font for the dialog and on your screen resolution.


Specify the height of the dialog in dialog units. Dialog units are based on the currently selected font for the dialog and on your screen resolution.


Specify the name of each control on a dialog. This is the name you use in the macro and in Help when referring to this control, so each control on the same dialog should have a unique name. Named Regions are case-sensitive.


Display the name of the dialog. This is the name you use in the macro when calling and dismissing this dialog. Named Regions are case-sensitive.


Create an OK button. Clicking this accepts the dialog settings and activates them. Selecting OK automatically fills in the Text box.


Create a Cancel button. Clicking this closes the dialog without implementing the changes. Selecting Cancel automatically fills in the Text box.


Create a Help button. Clicking this button calls the Help file associated with this dialog. Selecting Help automatically fills in the Text box.


Create a blank button and specify any name for it.


Create a button with two possible states (on or off). When users click the button, it does not automatically reflect the change. You must send a message to the dialog within the macro to change the state of the button.


Create a button with two possible states (on or off). When users click the button, it automatically changes state. No additional message within the macro is necessary.


Create a scroll bar that extends the length or width of the control automatically.


Create a scroll bar that appears at the left of the control.


Create a scroll bar that appears at the top of the scroll bar control.


Create a scroll bar that appears at the bottom of the scroll bar control.


Specify the smallest allowable value for scroll bars.


Specify the largest allowable value for scroll bars.


Specify how much each click on the scroll bar will change position.


Specify the initial position of the scroll bar.


Specify which types of files the Select File dialog displays in the List Files of Type combo box. This allows you to limit the types of files that users can choose to list: DOC (document files), SS (spreadsheet files), DB (database files), GR (graphics files), and All Files (*.*) (all files).


Enter the text you want to appear as static text on the dialog. Text longer than the display area is cut off at the right edge.


Select the style of control you want to use (WordPerfect* or Windows*).


Select the side of the radio button on which the text appears.


Select left, right, or center justification for static text. The text is justified in relation to the text area.


Select the side of the control on which the text will appear.


Create text that appears printed on the dialog without a border around it.


Create text that appears as white text on a darker gray, recessed background.


Create text that appears as black text on a raised, shadowed box.


Create text that appears with ellipses (...) replacing the middle of overly long pathnames.


Specify the name of the variable associated with the dialog control. Use this name in the macro when specifying the values for the variable.


Use this control to specify the path and filename of the file the viewer displays. Click the folder icon to select directories and files.


Display the line of code where the Debugger stopped the macro.


Continue playing the macro until the next defined breakpoint.


Go to the next statement in the macro, play it, then stop.


Go to the return of the next label.


Go to the next line after executing the current one.


Click to define breakpoints for the Debugger inside your macro. You no longer need to use the Step command.


Display all the variables that exist in the current routine. The local variables may have identical names in different user-defined routines. Click the column headings to change the way the variables are sorted. Double-click arrays to expand them. Click the variables to change their contents.


Display the variable type and contents.


Display local variables, which are defined inside the current routine and inside the current macro.


Display global variables, which are defined for all routines in all the macro files that execute with the current macro. Global variables end when the macros finish executing.


Display persistent variables, which are set for all macros running in the current session, independent or interconnected. Persistent variables end when you close the PerfectScript* session.


Display and edit the contents of the currently selected variable. If you enclose the value in quotes (""), the variable will be updated with a string value. If you use only numbers without quotes, the variable will be updated with a numeric value.


Update the contents of the selected variable with the contents of the edit box. You must click Update to change the value of a variable. Updating the value of an alias updates the original instance of the variable.


Displays the labels, functions, or procedures that are currently in progress in reverse order with the most recent on top. Select a routine, to cause the Variable list box to display the variables that exist in that routine.


Display all the breakpoints defined for the current macro. Click each one to make changes.


Remove all defined breakpoints.


Delete the selected breakpoint.


Disable a breakpoint to let the Debugger ignore it. Enable a breakpoint to return it to activity. Enabled breakpoints are checked, disabled breakpoints are not. You can also use the Spacebar or double-click to enable and disable a breakpoint. You cannot select multiple breakpoints.


Add the currently defined Location, Conditions, and Actions data as a new breakpoint. You must change the breakpoint's data before you can add it.


Update the currently selected breakpoint with the Location, Conditions, and Actions data you added or edited. You must change a breakpoint's data before you can update it.


Specify the type of breakpoint you want to use.


Specify which of the macro files involved in your macro will use this breakpoint. The list may change as the macro runs. You may type in other macro names (without a path). A blank applies the breakpoint to all macros.


Specify how many times (up to 99,999) to let a breakpoint go by before it stops.


Specify the label that the Debugger will stop at. You can also type in a label, with the correct capitalization.


Specify the variable to use as a breakpoint. You can break at every variable in every label, or just the label. Only variables inside the current routine will appear in the list, since each new procedure will have its own pool of local variables. You can also type in variable names, but they must use correct capitalization.


Specify the routine you want to use as a breakpoint.


Specify the .DLL to use as a breakpoint. The macro loads the .DLL, so all currently loaded .DLLs appear in the list. You can also type in a .DLL name (without a path). <all> or a blank uses every .DLL call as a breakpoint.


Specify a particular routine inside the .DLL you chose to use as a breakpoint. You may also type in a routine name, but you must use correct capitalization.


Select the product you want to use as a breakpoint. The list displays all products currently registered with PerfectScript*.


Select commands from the list to use as breakpoints. The command list changes, depending on the product you selected.


Specify the line number to use as a breakpoint. You can specify any line number from 1 to 99,999. Each macro file renumbers the lines, so you can specify a certain line in a certain macro file, or stop at a specified line in all the macro files.


Specify the label to use as a breakpoint. The Debugger stops at the next return, implied or explicit.


Close the dialog box without recording any of the changes you made.


Specify the path and filename of the application you want to run the macro in.


Click the Help button to view an overview topic about this dialog box.


Close the dialog box and implement the changes you made.


Convert a macro into WordPerfect* format for compiling and playing.


This is the macro file you selected to play or compile.


Specify the path and filename for the converted macro file. If you do not change the selected path and filename, the converted macro will overwrite the original macro file.


Dismiss the dialog box.


Double-click the product command you want to insert into the Command Edit box. Select another type to get a different list of product commands.


Select the parameter you want to insert into the Command Edit text box, then click Edit.


Select the member you want to insert into the Command Edit box, then click Edit.


Select the type of product commands you want to use.


Display the type of parameter currently selected.


Display the value of the currently selected member of a parameter.


Display the token the currently selected command gives to the program.


Double-click commands, then select parameters and members. Click Edit to insert them into this box. Edit the command if necessary, then click Insert to put it into your macro at the insertion point.


Click to insert the currently selected parameter or member into the Command Edit box so you can modify it.


Click to insert the contents of the Command Edit box into your macro at the insertion point.


Automatically open the Debugger when you start a macro.


Automatically open the Debugger when the macro you are playing runs into an error.


Add debugging information to any warnings, errors, or other messages that display while you compile a macro.


Create a file listing each line in your macro with the corresponding line number. This is very useful for debugging macros, since the line numbers correspond to the line numbers the Debugger uses.


Specify the path and filename of the macro editor you want to use. The Editor and the file format you choose must match.


Select the file format your macro editor uses.


Return all General preferences to their original settings.


Specify the directory you want to use as the default macro directory.


Specify the default filename extension you want to use for macros.


Display the macro name, lines compiled, and types of errors while your macro compiles.


This is the macro that is currently compiling.


This is how many lines have been compiled.


These are the number of errors, warnings, and fatal problems your macro contains.


Stop the current compile without finishing it.


Continue the compilation without repairing the error.


This is the problem the compiler ran into. The description tells you what kind of error it is and briefly describes the problem and the line it appears on.


This is the location of the error the compiler ran into. It tells you which macro file to check and which line in the macro has the problem.


Click the format you want to use for recording macros. The format should match the macro editor you select.


Click the number of parameters you want to appear per line.


Select to record all product prefixes when recording macros. The prefixes specify the application the macro should use when you play it.


Select to require named parameters while you record macros.


Specify the maximum length for lines in recorded macros.


Stop the macro you are currently running and debugging.


Click to create and edit breakpoints for the Debugger.


Create a new variable at this point in the macro.


These controls have specific help associated with them.


Expand an array so you can see and edit each variable within it.


This is the name of the macro file where this label, function, or procedure appears.


This is the line number in the displayed macro file where the label, function, or procedure appears. This line number corresponds to the line number in the .WCL file for this macro, but may be different from the line numbering in the original macro file.


Delete the selected variable. If it has content, you can also choose to set the content to undefined instead of deleting the variable entirely.


Click the type of variable you want to create.


Specify a name for the variable.


Specify a macro to compile, then click to compile the selected macro.


Click to add, delete, modify, and change the order of elements in the list.


Type or edit the item you want to add to the list, then click Add to insert the item into the list, or click Replace to change the list item.


These are the items currently in the list. Click items to select them.


Sort the list alphabetically.


Select the item you want to use as the highlighted option in the list when the dialog opens, then click Set Initial.


Insert the item in the List Item text box as a new entry in the list.


Replace the currently selected item with the contents of the List item text box. You can edit list entries by selecting an item, changing it, then clicking Replace.


Remove the selected item from the list.


Move the selected item one place up in the list.


Move the selected item one place down in the list.


This is the list item that will be highlighted when the list opens.


Select the state to determine whether the control will be checked, clear, or grayed when the dialog opens.


Specify the class of the custom control. Standard Windows classes include Button, ComboBox, Edit, ListBox, ScrollBar, and Static. Other  controls such as Meters and Spin buttons must be defined in a DLL.


Allow a user to apply attributes (bold, italic, and so on) to text in the edit box.


Allow soft returns in a multiple-line the edit box, causing text to  wrap to the next line.


Do not allow users to enter tabs in the edit box. Pressing Ctrl+Tab moves the user out of the control.


Create a scroll bar that appears at the right of the control.


Type a value for the parameter, or click Value to allow the application to supply a number.


This is how your macro will appear.


Click to update the displayed macro so that it includes the parameter value you specified.


Apply your current Preferences settings without closing the dialog box.


Use the common Corel* suite Open dialog instead of the Windows* 95 open dialog.


This is the Toolbar for the PerfectScript Debugger. Use it to quickly access debugging features.


Specify the text for the custom control.


Click the type of measurement the Dialog Editor will use to size and position your dialogs.


Close the dialog on exit.


Set your animation options. Animation allows you to step through macros line by line, automatically bringing up the debugging dialog box at each step so you can check the variables and other calls. You can specify how long the Debugger will pause before moving to the next step. Clicking inside the Debugger halts the animation, as do any breakpoints you have specified. Click Debug [image] Animate to resume automatic play.


Type the text for a custom message.


Log custom event messages in the Debugger Event Log.


Remove the variable from the Variables list box.


Remove the contents of the variable but leave the variable in the Variables list box.


Log standard event messages in the Debugger Event Log.


Display the "&" character as itself. If you do not select this option, typing & changes the next letter into a mnemonic.


Specify a style for the custom control.  The number in the text box defines a valid style within the control Window class.  For example, an edit control includes styles such as left, multiline, and password.  The values for standard Windows styles are in the Windows SDK.

When you use DialogAddControl to add a custom control to a dialog box, the WS_CHILD (0x40000000) and WS_VISIBLE (0x10000000) style bits are added by default.


Put an "X" button on the title bar of the dialog so users can click to close it.


Invoke the Debugger when the macro reaches this breakpoint. If you do not select this option, the Debugger will not break into the macro; the breakpoint will simply be noted as an entry in the Event Log.


Type the comment you want to add to the event log, then click Add. The comment appears next in the event log display and in the .log file, if you save it.


Save the event log as a text file with a filename you specify and a default .log extension.


Remove all entries from the event log.


Connect to the online information and support service you selected.


If you have a modem, these instructions tell you how to use an online service to get more information about suite applications.


Click to configure an online service you selected so you can get more information about suite applications.


Sets the location, size, named regions, variables, and other propeties for the custom controls in your dialog box.


Choose a typeface and point size for all text on your dialog. The caption font remains constant for all dialogs. Changes in font size and style do affect the size of the dialog.


Specify the sequence in which you want to tab through the controls. You must set the control order before grouping the controls.


Groups controls together. Defining a group box around a set of controls does not group them, and you must set the control order before grouping controls.


Specify the button you want to be activated when the user presses Enter on the control.


Specify the control that has the focus when the dialog opens.


Select the controls you want to tab to.